home *** CD-ROM | disk | FTP | other *** search
/ The Epic Collection 3 / Epic Collection 3, The (1997)(Epic Marketing)[!].iso / useful_tools / magiceye / magiceye.doc < prev    next >
Text File  |  1995-07-29  |  9KB  |  166 lines
  1.         __       __
  2.         )\\     /((  Version 37.2                            __
  3.        /  \\   /  \\         39.2  __         ________      / \\     ________
  4.       /    \\ /    \\              )\\        )      \\    (   ))    )      \\
  5.      / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
  6.     / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
  7.    / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  8.   / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
  9.  / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
  10. / //    @ 1995 by    \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
  11. \_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
  12.          sMail:                     eMail:                 _______  ___ _____
  13.      Christian Krapp                                      / __//\ \/ /// __//
  14.      Hagenmähderstr.9   krabbe@informatik.fh-augsburg.de / _//   \  /// _//
  15.    D-86391 Stadtbergen                                  / //__   / /// //__
  16.      (GERMANY)                                          \___//  /_// \___//
  17.                             An AugustA team Release!
  18. --------------------------------------------------------------------------------
  19.  
  20. Copyright:
  21.   This program and all accompanying files (program-icon) are copyrighted 1995 by
  22. Christian 'cr8y' Krapp! You can  copy these files to your friends as long as the
  23. files are unchanged. It is not allowed to demand a fee higher as media costs and
  24. a (little)  copy-fee. In addition,  no one is allowed to put these  files onto a
  25. PD-disk or an CD-Rom. You can get a permittion by the author. Please contact!
  26.  
  27. For the AmiNet, FreshFish and MeetingPearls CD-Rom's is no permittion requiered!
  28.  
  29.   This  program isn't  Public Domain or  Shareware. It's is developt as Freeware
  30. Everyone, who use this program, should  send me an postcard or an eMail. (I want
  31. to know, how many (or much? ;^) ) Amiga-Fans use this program).
  32.  
  33.   When you use this little program, than you use it on your own risk! The author
  34. take no respons for damage made by MagicEYE!
  35.  
  36. --------------------------------------------------------------------------------
  37.  
  38. What is it?
  39.   No: This  is not  again  a program  to render  3D pictures!  Do you  know  the
  40. MagicWB-  or NewIcons-Stuff? (what  a question ;^> ) And: I think you know these
  41. funny Eye-programs,  which fellow the mouse-pointer! Ok. Than you know MagicEYE.
  42. It's an Eye-program for an upstyled Workbench.
  43.  
  44. --------------------------------------------------------------------------------
  45.  
  46. 7 reasons, why to use this program:
  47.  
  48. 1.) colorized eyes ;^)
  49. 2.) automatic window close, when WB is closed (screennotify.library)
  50. 3.) you can configurate a lot
  51. 4.) patch to have an screen-drag MagicEYE-window
  52. 5.) 6(!) different eye-effects
  53. 6.) colorremapping, MagicWB nolonger needed (AmigaOS 3.0+)
  54. 7.) very short program
  55.  
  56. --------------------------------------------------------------------------------
  57.  
  58. What do you need?
  59.   You need  of course an  Amiga-Computer  (or an compatible  one ;^) ). Also you
  60. need  at least AmigaOS 2.04  or  higher. Sorry, but  I can't guarantee, that the
  61. version for  AmigaOS 2.04 work, because I  have only an  Amiga with AmigaOS 3.0.
  62. In  addition to the OS you  should run your Workbench with at least 8 colors and
  63. a quadratic resolution (e.g.  640×512).  Last  but  not least you should  use an
  64. 13 point  high font  for screen title.  This is necassery,  because MagicEYE has
  65. an fixed high of  13 points.  And new for  release 2 of  MagicEYE  you  need the
  66. screennotify-library from Stefan Becker (included).
  67.  
  68. --------------------------------------------------------------------------------
  69.  
  70. Different program versions:
  71.   It's very simple:  The 'new' AmigaOS 3.0  has some  better functions which are
  72. supported by MagicEYE. And so, I have produced two versions: One for AmigaOS 2.0
  73. (MagicEYE_37) and one for AmigaOS 3.0 (MagicEYE_39) and higher.
  74.  
  75. --------------------------------------------------------------------------------
  76.  
  77. How to install?
  78.   Nothing simpler than that: you copy only the right program-version of MagicEYE
  79. to your WBStartup-directory on you startvolume (disk, hd...). That's it :-]
  80.  
  81. --------------------------------------------------------------------------------
  82.  
  83. How to use?
  84.   You can run this program only from the Workbench (or the WBStartup directory).
  85. If you run it from a Shell, nothing happens! Also, all configuration is done in
  86. the icon ToolType:
  87.  
  88.   DONOTWAIT       : This has nothing  to do with  MagicEYE. It's only a flag for
  89.                     Workbench.
  90.   WIN_X           : Where  do you want to place  the MagicEYE-window?  Here  you
  91.   WIN_Y             configurate  the x and y  position.  Default:  WIN_X=545 and
  92.                     WIN_Y=1
  93.   PRIORITY        : Defines the task-priority.  This value should  be lower than
  94.                     0, so, other programs (which need the system-time) gets more
  95.                     system-time. The default value is 0 (program) or -5 (Icon).
  96.   DRAGPATCH       : With  this (non system-friendly)  patch it  is possible,  to
  97.                     drag the  screen  with the  MagicEYE-window.  So there is no
  98.                     different on  the screen-title,  when  you want to drag down
  99.                     the screen (funny). Default is off!
  100.   SLEEP_PERIOD    : This flag define the  time that  the program  wait,  till it
  101.                     close  the Eyes,  when the  mouse  isn't moved! Default: 50.
  102.                     (Try different values!)
  103.   FRESHUP_PER_SEC : This value  define,  how  often the  Eyes  are rendern  in a
  104.                     second. So, you have here the posibility to define, how much
  105.                     system-time is used from MagicEYE  (and of course  with  the
  106.                     PRIORITY).  An example: If you give as FRESHUP_PER_SEC an 1,
  107.                     the Eyes is renderd  once in a second. Default  is 50 (=> so
  108.                     MagicEYE renders the Eyes 50 times a second). The max. value
  109.                     for this flag  is 100 (Or have  you an screen-mode with more
  110.                     then 100Hz?). 
  111.  
  112. And now the effect-configuration. Very  important to know: The values,  that you
  113. give here, are interpreted as a probability (1/value). The value must be greater
  114. than 1:
  115.  
  116.   SLEEPY          : This  value is  needed, to  define how  often the  Eyes  are
  117.                     closed. 
  118.   TIRED           : Define, how often the eye-lid's go down to the half.
  119.   ROLL_SYNCHRON   : When roll the Eye synchron (in same direction).
  120.   ROLL_ASYNCHRON  : When roll the Eye asynchron (in different direction).
  121.   LEFTRIGHT       : How often the Eye's look Left-Right.
  122.   RANDOM_EYE      : Defines, when you get the trembling Eye's.
  123.   BLOODY          : When get the red Eye's?
  124.  
  125.   So, that's it.  You know now all the features  of MagicEYE. Or...? You want to
  126. know, how to exit this mega mighty program? Is it true? Do you want to quit this
  127. program?  Ok. I see... You want  know  this (very stupied :-|) feature: activate
  128. the MagicEYE-window (place the mouse-pointer over one eye and hit the left mouse
  129. button) and press the right mouse button. Now, the MagicEYE's should disappear.
  130.  
  131. --------------------------------------------------------------------------------
  132.  
  133. What can be made better?
  134.   * More funny things with the Eyes
  135.   * Produce it as an commodity
  136.   * Eye's with eyebrow's?
  137.   * It is possible, that there exists errors (undocumented features ;^) or bugs)
  138.     which we doesn't want!
  139.  
  140. --------------------------------------------------------------------------------
  141.  
  142. For any reaseon (bug-report, ideas ...) try this:
  143.  
  144.                  sMail:           Christian Krapp
  145.                                   Hagenmähderstr. 9
  146.                                 D-86391 Stadtbergen
  147.                                   (GERMANY)
  148.                  eMail:           krabbe@informatik.fh-augsburg.de
  149.  
  150. --------------------------------------------------------------------------------
  151.  
  152. History:         (xx means 37 (AmigaOS 2.04) or 39 (AmigaOS 3.0+))
  153.  
  154. Vxx.0   28.04.1995 - First try (produced MagicEYE-Animation).
  155. Vxx.1   16.06.1995 - After a long work it's done. The first public-version ok.
  156. Vxx.2   xx.xx.1995 - Silly error removed (Thanks Roland Fulde).
  157.                    - Colorizing implemented  (Markus Speicher and Mario Cattaneo
  158.                      were interessted, only 37.x-Version).
  159.                    - ScreenNotify-Library supported (Mario Cattaneo).
  160.                    - Rolling Eye (Dirk Wrocklage).
  161.                    - Tremble and red Eye's (Michael Krapp).
  162.                    - Rolling  Eye  asynchron,  tired  Eye  and  look  Left-Right
  163.                      (Christian Krapp)
  164.  
  165. --------------------------------------------------------------------------------
  166.